home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_xemacs.idb / usr / freeware / lib / xemacs-20.4 / info / w3.info-1.z / w3.info-1
Encoding:
GNU Info File  |  1998-05-21  |  48.7 KB  |  1,377 lines
  1. This is Info file ../info/w3.info, produced by Makeinfo version 1.68
  2. from the input file w3.texi.
  3.  
  4. INFO-DIR-SECTION World Wide Web
  5. INFO-DIR-SECTION GNU Emacs Lisp
  6. START-INFO-DIR-ENTRY
  7. * Emacs/W3: (w3).                 Emacs/W3 World Wide Web browser.
  8. END-INFO-DIR-ENTRY
  9.    This file documents the Emacs/W3 World Wide Web browser.
  10.  
  11.    Copyright (C) 1993, 1994, 1995, 1996 William M. Perry Copyright (C)
  12. 1996, 1997 Free Software Foundation
  13.  
  14.    Permission is granted to make and distribute verbatim copies of this
  15. manual provided the copyright notice and this permission notice are
  16. preserved on all copies.
  17.  
  18. 
  19. File: w3.info,  Node: Top,  Next: Getting Started,  Prev: (dir),  Up: (dir)
  20.  
  21. W3
  22. **
  23.  
  24.    Users can browse the World Wide Web from within Emacs by using
  25. Emacs/W3.  All of the widely used (and even some not very widely used)
  26. URL schemes are supported, and it is very easy to add new methods as the
  27. need arises.
  28.  
  29.    Emacs/W3 provides some core functionality that can be readily re-used
  30. from any program in Emacs.  Users and other package writers are
  31. encouraged to Web-enable their applications and daily work routines
  32. with the library.
  33.  
  34.    Emacs/W3 is completely customizable, both from Emacs-Lisp and from
  35. stylesheets *Note Stylesheets::  If there is any aspect of Emacs/W3 that
  36. cannot be modified to your satisfaction, please send mail to the
  37. w3-beta@indiana.edu mailing list with any suggestions.  *Note Reporting
  38. Bugs::
  39.  
  40.    This manual corresponds to Emacs/W3 v4.0pre.7
  41.  
  42. * Menu:
  43.  
  44. * Getting Started::             Getting up and running with Emacs/W3
  45. * Basic Usage::                 Basic movement and usage of Emacs/W3.
  46. * Compatibility::               Explanation of compatibility with
  47.                                 other browsers.
  48. * Stylesheets::                 How to control the look of web pages
  49. * Supported URLs::              What URL schemes are supported.
  50. * MIME Support::                Support for MIME
  51. * Security::                    Various security methods supported
  52. * Non-Unix Operating Systems::  Special considerations necessary to get
  53.                                 up and running correctly under non-unix
  54.                                 OS's.
  55. * Speech Integration::          Outputting to a speech synthesizer.
  56. * Advanced Features::           Some of the more arcane features.
  57. * More Help::                   How to get more help--mailing lists,
  58.                                 newsgroups, etc.
  59. * Future Directions::           Plans for future revisions
  60.  
  61. Appendices:
  62. * Reporting Bugs::              How to report a bug in Emacs/W3.
  63. * Dealing with Firewalls::      How to get around your firewall.
  64. * Proxy Gateways::              Using a proxy gateway with Emacs/W3.
  65. * Installing SSL::              Turning on SSL support.
  66. * Mailcap Files::               An explanation of Mailcap files.
  67. * Down with DoubleClick::       Annoyed by advertisements?  Read this!
  68.  
  69. Indices:
  70. * General Index::               General Index.
  71. * Key Index::                   Menus of command keys and their references.
  72.  
  73. 
  74. File: w3.info,  Node: Getting Started,  Next: Basic Usage,  Prev: Top,  Up: Top
  75.  
  76. Getting Started
  77. ***************
  78.  
  79.    If installed correctly, starting Emacs/W3 is quite painless.  Just
  80. type `M-x w3' in a running Emacs session.  This will retrieve the
  81. default page that has been configured (*note Preferences Panel::.) - by
  82. default the documentation for Emacs/W3 at Indiana University.
  83.  
  84.    If the default page is not retrieved correctly at startup, you will
  85. have to do some customization (*note Preferences Panel::.).
  86.  
  87.    Once started, you can use the mouse and the menu or use the following
  88. key commands (for more commands and more detail, *note Basic Usage:
  89. Basic Usage.).
  90.  
  91. move forward
  92.      press the space bar,
  93.  
  94. move backwards
  95.      press the backspace key,
  96.  
  97. move to the next HTML reference on the page
  98.      press the `TAB' key,
  99.  
  100. move to the previous HTML reference on the page
  101.      press the `SHIFT' and `TAB' keys at the same time.  If this does
  102.      not work (some text terminals cannot distinguish between `TAB' and
  103.      `SHIFT-TAB', pressing the `ALT' and `TAB' keys should also work.
  104.  
  105. follow a link
  106.      put the cursor over it and press the `RETURN' key, or
  107.      click the left mouse button on it,
  108.  
  109. fetch a URL
  110.      press the `Control' and `o' keys at the same time,
  111.      type the URL, and then press the `RETURN' key,
  112.  
  113. return to the last URL you were at
  114.      press the `l' key,
  115.  
  116. quit W3 mode
  117.      press the `q' key.
  118.  
  119. * Menu:
  120.  
  121. * Downloading::                 Where to download Emacs/W3.
  122. * Building and Installing::     Compiling and installing from source.
  123. * Startup Files::               What is where, and why.
  124. * Preferences Panel::           Quick configuration of common options.
  125.  
  126. 
  127. File: w3.info,  Node: Downloading,  Next: Building and Installing,  Prev: Getting Started,  Up: Getting Started
  128.  
  129. Downloading
  130. ===========
  131.  
  132.    :: WORK :: What you need, and why
  133. :: WORK :: Where to download Emacs, XEmacs, various platforms
  134. :: WORK :: Where to download Emacs/W3
  135. :: WORK :: Where to download related utilities (netpbm, xv, gimp, etc.)
  136.  
  137. 
  138. File: w3.info,  Node: Building and Installing,  Next: Startup Files,  Prev: Downloading,  Up: Getting Started
  139.  
  140. Building and Installing
  141. =======================
  142.  
  143.    :: WORK :: Document makefile variables
  144. :: WORK :: Document what gets installed where, why
  145.  
  146. 
  147. File: w3.info,  Node: Startup Files,  Next: Preferences Panel,  Prev: Building and Installing,  Up: Getting Started
  148.  
  149. Startup Files
  150. =============
  151.  
  152.    :: WORK :: startup files
  153. This section should document where Emacs/W3 looks for its startup files,
  154. and what each one does.  'profile' 'stylesheet' 'hotlist' 'history' etc.
  155.  
  156. 
  157. File: w3.info,  Node: Preferences Panel,  Prev: Startup Files,  Up: Getting Started
  158.  
  159. Preferences Panel
  160. =================
  161.  
  162.    :: WORK :: pref panel
  163. This should document the quick preferences panel.  M-x
  164. w3-preferences-edit
  165.  
  166. 
  167. File: w3.info,  Node: Basic Usage,  Next: Compatibility,  Prev: Getting Started,  Up: Top
  168.  
  169. Basic Usage
  170. ***********
  171.  
  172.    Emacs/W3 is similar to the Info package all Emacs users hold near and
  173. dear to their hearts (*Note Info: (info)Top, for a description of
  174. Info).  Basically, `space' and `backspace' control scrolling, and
  175. `return' or the middle mouse button follows a hypertext link.  The
  176. `tab' and `Meta-tab' keys maneuver around the various links on the page.
  177.  
  178.    NOTE: Starting with Emacs/W3 4.0, form entry areas in a page can be
  179. typed directly into.  This is one of the main differences in navigation
  180. from version 2.0.  If you are used to using the `f' and `b' keys to
  181. navigate around a buffer, I suggest training yourself to always use
  182. `tab' and `M-tab' - it will save time and frustration on pages with
  183. lots of form fields.
  184.  
  185.    By default, hypertext links are surrounded by '[[' and ']]' on
  186. non-graphic terminals (VT100, DOS window, etc.).  On a graphics
  187. terminal, the links are in shown in different colors.  *Note
  188. Stylesheets:: for information on how to change this.
  189.  
  190.    There are approximately 50 keys bound to special Emacs/W3 functions.
  191. The basic rule of thumb regarding keybindings in Emacs/W3 is that a
  192. lowercase key takes an action on the current document, and an uppercase
  193. key takes an action on the document pointed to by the hypertext link
  194. under the cursor.
  195.  
  196.    There are several areas that the keybindings fall into: movement,
  197. information, action, and miscellaneous.
  198.  
  199. * Menu:
  200.  
  201. * Movement::                    Moving around in the buffer.
  202. * Information::                 Getting information about a document.
  203. * Action::                      Following links, printing, etc.
  204. * Miscellaneous::               Everything else.
  205.  
  206. 
  207. File: w3.info,  Node: Movement,  Next: Information,  Prev: Basic Usage,  Up: Basic Usage
  208.  
  209. Movement
  210. ========
  211.  
  212.    All the standard Emacs bindings for movement are still in effect,
  213. with a few additions for convenience.
  214.  
  215. `space'
  216.      Scroll downward in the buffer.  With prefix arg, scroll down that
  217.      many screenfuls.
  218.  
  219. `backspace'
  220.      Scroll upward in the buffer.  With prefix arg, scroll up that many
  221.      screenfuls.
  222.  
  223. `<'
  224.      Goes to the start of document
  225.  
  226. `>'
  227.      Goes to the end of document
  228.  
  229. `Meta-tab, Shift-tab, b'
  230.      Attempts to move backward one link area in the current document.
  231.      Signals an error if no previous links are found.
  232.  
  233. `tab, f, n'
  234.      Attempts to move forward one link area in the current document.
  235.      Signals an error if no more links are found.
  236.  
  237. `B'
  238.      Move backwards in the history stack.
  239.  
  240. `F'
  241.      Move forwards in the history stack.
  242.  
  243. `l'
  244.      Return to the last buffer shown before this buffer.
  245.  
  246. `q'
  247.      Kill this buffer.
  248.  
  249. `Q, u'
  250.      Bury this buffer, but don't kill it
  251.  
  252. 
  253. File: w3.info,  Node: Information,  Next: Action,  Prev: Movement,  Up: Basic Usage
  254.  
  255. Information
  256. ===========
  257.  
  258.    These functions relate information about one or more links on the
  259. current document.
  260.  
  261. `v'
  262.      This shows the URL of the current document in the minibuffer.
  263.  
  264. `V'
  265.      This shows the URL of the hypertext link under point in the
  266.      minibuffer.
  267.  
  268. `i'
  269.      Shows miscellaneous information about the currently displayed
  270.      document.  This includes the URL, the last modified date, MIME
  271.      headers, the HTTP response code, and any relationships to other
  272.      documents.  Any security information is also displayed.
  273.  
  274. `I'
  275.      Shows information about the URL at point.
  276.  
  277. `s'
  278.      This shows the HTML source of the current document in a separate
  279.      buffer.  The buffer's name is based on the document's URL.
  280.  
  281. `S'
  282.      Shows the HTML source of the hypertext link under point in a
  283.      separate buffer.  The buffer's name is based on the document's URL.
  284.  
  285. `k'
  286.      This stores the current document's URL in the kill ring, and also
  287.      in the current window-system's clipboard, if possible.
  288.  
  289. `K'
  290.      Stores the URL of the document under point in the kill ring, and
  291.      also in the current window-system's clipboard, if possible.
  292.  
  293. 
  294. File: w3.info,  Node: Action,  Next: Miscellaneous,  Prev: Information,  Up: Basic Usage
  295.  
  296. Action
  297. ======
  298.  
  299.    First, here are the keys and functions that bring up a new hypertext
  300. page, usually creating a new buffer.
  301. `m'
  302.      Choose a link from the current buffer and follow it.  A
  303.      completing-read is done on all the links, so `space' and `TAB' can
  304.      be used for completion.
  305.  
  306. `return'
  307.      Pressing return when over a hyperlink attempts to follow the link
  308.      under the cursor.  With a prefix argument (`C-u'), this forces the
  309.      file to be saved to disk instead of being passed off to other
  310.      viewers or being parsed as HTML.
  311.  
  312.      Pressing return when over a form input field can cause
  313.      auto-submission of the form.  This is for Mosaic and Netscape
  314.      compatibility.  If there is only one item in the form other than
  315.      submit or reset buttons, then the form will be submitted.
  316.  
  317. `Middle Mouse Button'
  318.      Attempt to follow a hypertext link under the mouse cursor.
  319.      Clicking on a form input field will prompt in the minibuffer for
  320.      the data to insert into the input field.  Type checking is done,
  321.      and the data is only entered into the form when data of the
  322.      correct type is entered (ie: cannot enter 44 for 'date' field,
  323.      etc).
  324.  
  325. `Control Middle Mouse Button, Meta return'
  326.      Tries to retrieve the inlined image that is under point.  It
  327.      ignores any form entry areas or hyperlinks, and blindly follows
  328.      any inlined image.  Useful for seeing images that are meant to be
  329.      used as hyperlinks when not on a terminal capable of displaying
  330.      graphics.
  331.  
  332. `p'
  333.      Prints out the current buffer in a variety of formats, including
  334.      PostScript, HTML source, or formatted text.
  335.  
  336. `P'
  337.      Prints out the URL under point in a variety of formats, including
  338.      PostScript, HTML source, or formatted text.
  339.  
  340. `m'
  341.      Selects a destination from a list of all the hyperlinks in the
  342.      current buffer.  Use `space' and `tab' to complete on the links.
  343.  
  344. `r, g'
  345.      Reloads the current document.  The position within the buffer
  346.      remains the same (unless the document has changed since it was
  347.      last retrieved, in which case it should be relatively close).
  348.      This causes an unconditional reload from the remote server - the
  349.      locally cached copy is not consulted.
  350.  
  351. `C-o'
  352.      Prompts for a URL in the minibuffer, and attempts to fetch it.  If
  353.      there are any errors, or Emacs/W3 cannot understand the type of
  354.      link requested, the errors are displayed in a hypertext buffer.
  355.  
  356. `o'
  357.      Opens a local file, interactively.  This prompts for a local file
  358.      name to open.  The file must exist, and may be a directory.  If
  359.      the requested file is a directory and `url-use-hypertext-dired' is
  360.      `nil', then a dired-mode buffer is displayed.  If non`nil', then
  361.      Emacs/W3 automatically generates a hypertext listing of the
  362.      directory.  The hypertext mode is the default, so that all the
  363.      keys and functions remain the same.
  364.  
  365. `M-s'
  366.      Save a document to the local disk as HTML Source, Formatted Text,
  367.      LaTeX Source, or Binary.
  368.  
  369. `Hv'
  370.      If `url-keep-history' is non-`nil', then Emacs/W3 keeps track of
  371.      all the URLs visited in an Emacs session.  This function takes all
  372.      the links that are in that internal list, and formats them as
  373.      hypertext links in a list.
  374.  
  375.    And here are the commands to move around between Emacs/W3 buffers:
  376.  
  377. `l'
  378.      Goes to the last WWW buffer seen.
  379.  
  380. `q'
  381.      Quits WWW mode.  This kills the current buffer and goes to the most
  382.      recently visited buffer.
  383.  
  384. `u'
  385.      This is similar to w3-quit, but the buffer is not killed, it is
  386.      moved to the bottom of the buffer list (so it is the least likely
  387.      to show up as the default with switch-to-buffer).  This is
  388.      different from `w3-goto-last-buffer' in that it does not return to
  389.      the last WWW page visited - it is the same as using
  390.      `switch-to-buffer' - the buffer left in the window is fairly
  391.      random.
  392.  
  393. `HB, B'
  394.      Takes one step back along the path in the current history.  Has no
  395.      effect if at the beginning of the session history.
  396.  
  397. `HF, F'
  398.      Takes one step forward along the path in the current history.  Has
  399.      no effect if at the end of the session history.
  400.  
  401. 
  402. File: w3.info,  Node: Miscellaneous,  Prev: Action,  Up: Basic Usage
  403.  
  404. Miscellaneous
  405. =============
  406.  
  407. `M-m'
  408.      Mails the current document to someone.  Choose from several
  409.      different formats to mail: formatted text, HTML source,
  410.      PostScript, or LaTeX source.  When the HTML source is mailed, then
  411.      an appropriate <base> tag is inserted at the beginning of the
  412.      document so that relative links may be followed correctly by
  413.      whoever receives the mail.
  414.  
  415. `M-M'
  416.      Mails the document pointed to by the hypertext link under point to
  417.      someone.  Choose from several different formats to mail: formatted
  418.      text, HTML source, PostScript, or LaTeX source.  When the HTML
  419.      source is mailed, then an appropriate <base> tag is inserted at
  420.      the beginning of the document so that relative links may be
  421.      followed correctly by whoever receives the mail.
  422.  
  423. `p'
  424.      Prints the current document.  Choose from several different
  425.      formats to print: formatted text, HTML source, PostScript (with
  426.      ps-print), or by using LaTeX and dvips).
  427.  
  428.      When the formatted text is printed, the normal `lpr-buffer'
  429.      function is called, and the variables `lpr-command' and
  430.      `lpr-switches' control how the document is printed.
  431.  
  432.      When the HTML source is printed, then an appropriate <base> tag is
  433.      inserted at the beginning of the document.  When postscript is
  434.      printed, then the HTML source of the document is converted into
  435.      LaTeX source.  There are several variables controlling what the
  436.      final LaTeX document looks like.
  437.  
  438.      :: WORK :: Document the new LaTeX backend
  439.  
  440.     `w3-latex-use-latex2e'
  441.           If non-`nil', configures the LaTeX engine to use the LaTeX2e
  442.           syntax.  A `nil' value indicates that LaTeX 2.0.9
  443.           compabibility will be used instead.
  444.  
  445.     `w3-latex-docstyle'
  446.           The document style to use when printing or mailing converted
  447.           HTML files in LaTeX.  Good defaults are: {article},
  448.           [psfig,twocolumn]{article}, etc.
  449.  
  450.     `w3-latex-packages'
  451.           List of LaTeX packages to include.  Currently this is only
  452.           used if `w3-latex-use-latex2e' is non-`nil'.
  453.  
  454.     `w3-latex-use-maketitle'
  455.           If non-`nil', the LaTeX engine will use real LaTeX title
  456.           pages for document titles.
  457.  
  458.     `w3-latex-print-links'
  459.           If non-`nil', prints the URLs of hypertext links as endnotes
  460.           at the end of the document.  If set to `footnote', prints the
  461.           URL's as footnotes on each page.
  462.  
  463. `P'
  464.      Prints the document pointed to by the hypertext link under point.
  465.      Please see the previous item for more information.
  466.  
  467. `M-x w3-insert-formatted-url'
  468.      Insert a fully formatted HTML link into another buffer.  This gets
  469.      the name and URL of either the current buffer, or, with a prefix
  470.      arg, of the link under point, and construct the appropriate
  471.      <a...>...</a> markup and insert it into the desired buffer.
  472.  
  473. `M-tab'
  474.      Inserts the URL of the current document into another buffer.
  475.      Buffer is prompted for in the minibuffer.  With prefix arg, uses
  476.      the URL of the link under point.
  477.  
  478. `U'
  479.      Selects one of the <LINK> tags from this document and fetch it.
  480.      Links are attributes of a specific document, and can tell such
  481.      things as who made the document, where a table of contents is
  482.      located, etc.
  483.  
  484.      Link tags specify relationships between documents in two ways.
  485.      Normal (forward) relationships (where the link has a REL="xxx"
  486.      attribute), and reverse relationships (where the link has a
  487.      REV="xxx" attribute).  This first asks what type of link to follow
  488.      (Normal or Reverse), then does a `completing-read' on only the
  489.      links that have that type of relationship.
  490.  
  491. 
  492. File: w3.info,  Node: Compatibility,  Next: Stylesheets,  Prev: Basic Usage,  Up: Top
  493.  
  494. Compatibility with other Browsers
  495. *********************************
  496.  
  497.    Due to the popularity of several other browsers, Emacs/W3 offers an
  498. easy transition to its much better way of life.  This ranges from being
  499. able to share the same preferences files and disk cache to actually
  500. emulating the keybindings used in other browsers.
  501.  
  502. * Menu:
  503.  
  504. * Emulation::                   Emacs/W3 can emulate the keybindings and
  505.                 other behaviours of other browsers.
  506. * Hotlist Handling::            A hotlist is an easy way to keep track of
  507.                 interesting Web pages without having to
  508.                 remember the exact path to get there.
  509. * Session History::             Keeping a history of documents visited
  510.                 in one Emacs sessions allows the use of
  511.                 'forward' and 'back' buttons easily.
  512. * Global History::              Keeping a history of all the places ever
  513.                 visited on the web.
  514.  
  515. 
  516. File: w3.info,  Node: Emulation,  Next: Hotlist Handling,  Prev: Compatibility,  Up: Compatibility
  517.  
  518. Emulation
  519. =========
  520.  
  521.    :: WORK :: Document lynx emulation
  522. `Down arrow'
  523.      Highlight next topic
  524.  
  525. `Up arrow'
  526.      Highlight previous topic
  527.  
  528. `Right arrow, Return, Enter'
  529.      Jump to highlighted topic
  530.  
  531. `Left arrow'
  532.      Return to previous topic
  533.  
  534. `+'
  535.      Scroll down to next page (Page-Down)
  536.  
  537. `-'
  538.      Scroll up to previous page (Page-Up)
  539.  
  540. `SPACE'
  541.      Scroll down to next page (Page-Down)
  542.  
  543. `b'
  544.      Scroll up to previous page (Page-Up)
  545.  
  546. `C-A'
  547.      Go to first page of the current document (Home)
  548.  
  549. `C-E'
  550.      Go to last page of the current document (End)
  551.  
  552. `C-B'
  553.      Scroll up to previous page (Page-Up)
  554.  
  555. `C-F'
  556.      Scroll down to next page (Page-Down)
  557.  
  558. `C-N'
  559.      Go forward two lines in the current document
  560.  
  561. `C-P'
  562.      Go back two lines in the current document
  563.  
  564. `)'
  565.      Go forward half a page in the current document
  566.  
  567. `('
  568.      Go back half a page in the current document
  569.  
  570. `#'
  571.      Go to Toolbar or Banner in the current document
  572.  
  573. `?, h'
  574.      Help (this screen)
  575.  
  576. `a'
  577.      Add the current link to a bookmark file
  578.  
  579. `c'
  580.      Send a comment to the document owner
  581.  
  582. `d'
  583.      Download the current link
  584.  
  585. `e'
  586.      Edit the current file
  587.  
  588. `g'
  589.      Goto a user specified URL or file
  590.  
  591. `i'
  592.      Show an index of documents
  593.  
  594. `j'
  595.      Execute a jump operation
  596.  
  597. `k'
  598.      Show a list of key mappings
  599.  
  600. `l'
  601.      List references (links) in current document
  602.  
  603. `m'
  604.      Return to main screen
  605.  
  606. `o'
  607.      Set your options
  608.  
  609. `p'
  610.      Print the current document
  611.  
  612. `q'
  613.      Quit
  614.  
  615. `/'
  616.      Search for a string within the current document
  617.  
  618. `s'
  619.      Enter a search string for an external search
  620.  
  621. `n'
  622.      Go to the next search string
  623.  
  624. `v'
  625.      View a bookmark file
  626.  
  627. `V'
  628.      Go to the Visited Links Page
  629.  
  630. `x'
  631.      Force submission of form or link with no-cache
  632.  
  633. `z'
  634.      Cancel transfer in progress
  635.  
  636. `[backspace]'
  637.      Go to the history Page
  638.  
  639. `='
  640.      Show file and link info
  641.  
  642. `\'
  643.      Toggle document source/rendered view
  644.  
  645. `!'
  646.      Spawn your default shell
  647.  
  648. `*'
  649.      Toggle image_links mode on and off
  650.  
  651. `['
  652.      Toggle pseudo_inlines mode on and off
  653.  
  654. `]'
  655.      Send an HTTP HEAD request for the current doc or link
  656.  
  657. `C-R'
  658.      Reload current file and refresh the screen
  659.  
  660. `C-W'
  661.      Refresh the screen
  662.  
  663. `C-U'
  664.      Erase input line
  665.  
  666. `C-G'
  667.      Cancel input or transfer
  668.  
  669. `C-T'
  670.      Toggle trace mode on and off
  671.  
  672. `C-K'
  673.      Invoke the Cookie Jar Page
  674.  
  675. :: WORK :: Document netscape emulation
  676. Uh, turn this into pretty tables about what keys are emulated.
  677.  
  678.      (define-key w3-netscape-emulation-minor-mode-map "\M-s" 'w3-save-as)
  679.      (define-key w3-netscape-emulation-minor-mode-map "\M-m" 'w3-mailto)
  680.      (define-key w3-netscape-emulation-minor-mode-map "\M-n" 'make-frame)
  681.      (define-key w3-netscape-emulation-minor-mode-map "\M-l" 'w3-fetch)
  682.      (define-key w3-netscape-emulation-minor-mode-map "\M-o" 'w3-open-local)
  683.      (define-key w3-netscape-emulation-minor-mode-map "\M-p" 'w3-print-this-url)
  684.      (define-key w3-netscape-emulation-minor-mode-map "\M-q" 'w3-quit)
  685.      (define-key w3-netscape-emulation-minor-mode-map "\M-f" 'w3-search-forward)
  686.      (define-key w3-netscape-emulation-minor-mode-map "\M-g" 'w3-search-again)
  687.      (define-key w3-netscape-emulation-minor-mode-map "\M-r" 'w3-reload-document)
  688.      (define-key w3-netscape-emulation-minor-mode-map "\M-i" 'w3-load-delayed-images)
  689.      (define-key w3-netscape-emulation-minor-mode-map "\M-a" 'w3-hotlist-add-document)
  690.      (define-key w3-netscape-emulation-minor-mode-map "\M-b" 'w3-show-hotlist)
  691.      (define-key w3-netscape-emulation-minor-mode-map "\M-h" 'w3-show-history-list)
  692.  
  693. 
  694. File: w3.info,  Node: Hotlist Handling,  Next: Session History,  Prev: Emulation,  Up: Compatibility
  695.  
  696. Hotlist Handling
  697. ================
  698.  
  699.    :: WORK :: Document that it supports different types of hotlist
  700. formats
  701. :: WORK :: Make sure everything hotlist related can be accessed via 'h'
  702. In order to avoid having to traverse many documents to get to the same
  703. document over and over, Emacs/W3 supports a "hotlist" like Mosaic.
  704. This is a file that contains URLs and aliases.  Hotlists allow quick
  705. access to any document in the Web, providing it has been visited and
  706. added to the hotlist.  The variable `w3-hotlist-file' determines where
  707. this information is saved.  The structure of the file is compatible
  708. with Mosaic's hotlist file, so this defaults to
  709. `~/.mosaic-hotlist-default'.
  710.  
  711.    Hotlist commands are:
  712. `a'
  713.      Adds the current document to the hotlist, with the buffer name as
  714.      its identifier.  Modifies the file specified by `w3-hotlist-file'.
  715.      If this is given a prefix-argument (via `C-u'), the title is
  716.      prompted for instead of automatically defaulting to the document
  717.      title.
  718.  
  719. `hR'
  720.      This rereads the default hostlist file specified by
  721.      `w3-hotlist-file'.
  722.  
  723. `d'
  724.      Prompts for the alias of the entry to kill.  Pressing the spacebar
  725.      or tab will list out partial completions.  The internal
  726.      representation of the hotlist and the file specified by
  727.      `w3-hotlist-file' are updated.
  728.  
  729. `hr'
  730.      Some hotlist item names can be very unwieldy (`Mosaic for X level
  731.      2 fill out form support'), or uninformative (`Index of /').
  732.      Prompts for the item to rename in the minibuffer--use the spacebar
  733.      or tab key for completion.  After having chosen an item to rename,
  734.      prompts for a new title until a unique title is entered.  Modifies
  735.      the file specified by `w3-hotlist-file'.
  736.  
  737. `hu'
  738.      Prompts for the alias to jump to.  Pressing the <spacebar> or
  739.      <tab> key shows partial completions.
  740.  
  741. `hv'
  742.      Converts the hotlist into HTML and displays it.
  743.  
  744. `ha'
  745.      Shows the hotlist entries matching a regular expression.
  746.  
  747. `hA'
  748.      Appends another hotlist file to the one currently in memory.
  749.  
  750. 
  751. File: w3.info,  Node: Session History,  Next: Global History,  Prev: Hotlist Handling,  Up: Compatibility
  752.  
  753. History
  754. =======
  755.  
  756.    Almost all web browsers keep track of the URLs followed from a page,
  757. so that it can provide forward and back buttons to keep a path of URLs
  758. that can be traversed easily.
  759.  
  760.    If the variable `url-keep-history' is `t', then Emacs/W3 keeps a
  761. list of all the URLs visited in a session.
  762.  
  763.    To view a listing of the history for this session of Emacs/W3, use
  764. `M-x w3-show-history' from any buffer, and Emacs/W3 generates an HTML
  765. document showing every URL visited since Emacs started (or cleared the
  766. history list), and then format it.  Any of the links can be chosen and
  767. followed to the original document.  To clear the history list, choose
  768. 'Clear History' from the 'Options' menu.
  769.  
  770.    Another twist on the history list mechanism is the fact that all
  771. Emacs/W3 buffers remember what URL, buffer, and buffer position of the
  772. last document, and also keeps track of the next location jumped to from
  773. that buffer.  This means that the user can go forwards and backwards
  774. very easily along the path taken to reach a particular document.  To go
  775. forward, use the function `w3-forward-in-history', to go backward, use
  776. the function `w3-backward-in-history'.
  777.  
  778. 
  779. File: w3.info,  Node: Global History,  Prev: Session History,  Up: Compatibility
  780.  
  781. Global History
  782. ==============
  783.  
  784.    :: WORK :: Document that the global history can have diff. formats
  785. Most web browsers also support the idea of a "history" of URLs the user
  786. has visited, and it displays them in a different style than normal URLs.
  787.  
  788.    If the variable `url-keep-history' is `t', then Emacs/W3 keeps a
  789. list of all the URLs visited in a session.  The file is automatically
  790. written to disk when exiting emacs.  The list is added to those already
  791. in the file specified by `url-global-history-file', which defaults to
  792. `~/.mosaic-global-history'.
  793.  
  794.    If any URL in the list is found in the file, it is not saved, but new
  795. ones are added at the end of the file.
  796.  
  797.    The function that saves the global history list is smart enough to
  798. notice what style of history list is being used (Netscape, Emacs/W3, or
  799. XMosaic), and writes out the new additions appropriately.
  800.  
  801.    One of the nice things about keeping a global history files is that
  802. Emacs/W3 can use it as a completion table.  When doing `M-x w3-fetch',
  803. pressing the `tab' or `space' key will show all completions for a
  804. partial URL.  This is very useful, especially for very long URLs that
  805. are not in a hotlist, or for seeing all the pages from a particular web
  806. site before choosing which to retrieve.
  807.  
  808. 
  809. File: w3.info,  Node: Stylesheets,  Next: Supported URLs,  Prev: Compatibility,  Up: Top
  810.  
  811. Stylesheets
  812. ***********
  813.  
  814.    The way in which Emacs/W3 formats a document is very customizable.
  815. All formatting is now controlled by a default stylesheet set by the user
  816. with the `w3-default-stylesheet' variable.  Emacs/W3 currently supports
  817. the W3C recommendation for Cascading Style Sheets, Level 1 (commonly
  818. known as CSS1) with a few experimental items from other W3C proposals.
  819. Wherever Emacs/W3 diverges from the specification, it will be clearly
  820. documented, and will be changed once a full standard is available.
  821.  
  822.    Support for DSSSL is progressing, but spare time is at an all-time
  823. low.  If anyone would like to help, please contact the author.
  824.  
  825.    The following sections closely parallel the CSS1 specification so it
  826. should be very easy to look up what Emacs/W3 supports when browsing
  827. through the CSS1 specification.  Please note that a lot of the text in
  828. the following sections comes directly from the specification as well.
  829.  
  830. * Menu:
  831.  
  832. * Terminology::                 Terms used in the rest of this chapter.
  833. * Basic Concepts::              Why are stylesheets useful?  Getting started.
  834. * Pseudo-Classes/Elements::     Special classes for elements.
  835. * The Cascade::                 How stylesheets are combined.
  836. * Properties::                  What properties you can set on elements.
  837. * Units::                       What you can set them to.
  838.  
  839. 
  840. File: w3.info,  Node: Terminology,  Next: Basic Concepts,  Prev: Stylesheets,  Up: Stylesheets
  841.  
  842. Terminology
  843. ===========
  844.  
  845. "attribute"
  846.      HTML attribute, ie: `align=center' - align is the attribute.
  847.  
  848. "author"
  849.      The author of an HTML document.
  850.  
  851. "block-level element"
  852.      An element which has a line break before and after (e.g. 'H1' in
  853.      HTML).
  854.  
  855. "canvas"
  856.      The part of the UA's drawing surface onto which documents are
  857.      rendered.
  858.  
  859. "child element"
  860.      A subelement in SGML terminology.
  861.  
  862. "contextual selector"
  863.      A selector that matches elements based on their position in the
  864.      document structure. A contextual selector consists of several
  865.      simple selectors. E.g., the contextual selector 'H1.initial B'
  866.      consists of two simple selectors, 'H1.initial' and 'B'.
  867.  
  868. "CSS"
  869.      Cascading Style Sheets.
  870.  
  871. "declaration"
  872.      A property (e.g. 'font-size') and a corresponding value (e.g.
  873.      '12pt').
  874.  
  875. "designer"
  876.      The designer of a style sheet.
  877.  
  878. "document"
  879.      HTML document.
  880.  
  881. "element"
  882.      HTML element.
  883.  
  884. "element type"
  885.      A generic identifier in SGML terminology.
  886.  
  887. "fictional tag sequence"
  888.      A tool for describing the behavior of pseudo-classes and
  889.      pseudo-elements.
  890.  
  891. "font size"
  892.      The size for which a font is designed. Typically, the size of a
  893.      font is approximately equal to the distance from the bottom of the
  894.      lowest letter with a descender to the top of the tallest letter
  895.      with an ascender and (optionally) with a diacritical mark.
  896.  
  897. "HTML extension"
  898.      Markup introduced by UA vendors, most often to support certain
  899.      visual effects. The FONT, CENTER and BLINK elements are examples
  900.      of HTML extensions, as is the BGCOLOR attribute. One of the goals
  901.      of CSS is to provide an alternative to HTML extensions.
  902.  
  903. "inline element"
  904.      An element which does not have a line break before and after (e.g.
  905.      'STRONG' in HTML)
  906.  
  907. "intrinsic dimensions"
  908.      The width and height as defined by the element itself, not imposed
  909.      by the surroundings. In this specification it is assumed that all
  910.      replaced elements - and only replaced elements - come with
  911.      intrinsic dimensions.
  912.  
  913. "parent element"
  914.      The containing element in SGML terminology.
  915.  
  916. "pseudo-element"
  917.      Pseudo-elements are used in CSS selectors to address typographical
  918.      items (e.g. the first line of an element) rather than structural
  919.      elements.
  920.  
  921. "pseudo-class"
  922.      Pseudo-classes are used in CSS selectors to allow information
  923.      external to the HTML source (e.g. the fact that an anchor has been
  924.      visited or not) to classify elements.
  925.  
  926. "property"
  927.      A stylistic parameter that can be influenced through CSS.
  928.  
  929. "reader"
  930.      The person for whom the document is rendered.
  931.  
  932. "replaced element"
  933.      An element that the CSS formatter only knows the intrinsic
  934.      dimensions of. In HTML, IMG, INPUT, TEXTAREA, SELECT and OBJECT
  935.      elements can be examples of replaced elements. E.g., the content
  936.      of the IMG element is often replaced by the image that the SRC
  937.      attribute points to.  CSS1 does not define how the intrinsic
  938.      dimensions are found.
  939.  
  940. "rule"
  941.      A declaration (e.g. 'font-family: helvetica') and its selector
  942.      (e.g. 'H1').
  943.  
  944. "selector"
  945.      A string that identifies what elements the corresponding rule
  946.      applies to. A selector can either be a simple selector (e.g. 'H1')
  947.      or a contextual selector (e.g. 'H1 B') which consists of several
  948.      simple selectors.
  949.  
  950. "SGML"
  951.      Standard Generalized Markup Language, of which HTML is an
  952.      application.
  953.  
  954. "simple selector"
  955.      A selector that matches elements based on the element type and/or
  956.      attributes, and not the element's position in the document
  957.      structure. E.g., 'H1.initial' is a simple selector.
  958.  
  959. "style sheet"
  960.      A collection of rules.
  961.  
  962. "UA"
  963.      User Agent, often a web browser or web client.
  964.  
  965. "user"
  966.      Synonymous with reader.
  967.  
  968. "weight"
  969.      The priority of a rule.
  970.  
  971. 
  972. File: w3.info,  Node: Basic Concepts,  Next: Pseudo-Classes/Elements,  Prev: Terminology,  Up: Stylesheets
  973.  
  974. Basic Concepts
  975. ==============
  976.  
  977.    Designing simple style sheets is easy. One needs only to know a
  978. little HTML and some basic desktop publishing terminology. E.g., to set
  979. the text color of 'H1' elements to blue, one can say:
  980.  
  981.        H1 { color: blue }
  982.  
  983.    The example above is a simple CSS rule. A rule consists of two main
  984. parts: selector ('H1') and declaration ('color: blue'). The declaration
  985. has two parts: property ('color') and value ('blue'). While the example
  986. above tries to influence only one of the properties needed for rendering
  987. an HTML document, it qualifies as a style sheet on its own. Combined
  988. with other style sheets (one fundamental feature of CSS is that style
  989. sheets are combined) it will determine the final presentation of the
  990. document.
  991.  
  992.    The selector is the link between the HTML document and the style
  993. sheet, and all HTML element types are possible selectors.
  994.  
  995. 
  996. File: w3.info,  Node: Pseudo-Classes/Elements,  Next: The Cascade,  Prev: Basic Concepts,  Up: Stylesheets
  997.  
  998. Pseudo-Classes/Elements
  999. =======================
  1000.  
  1001.    In CSS1, style is normally attached to an element based on its
  1002. position in the document structure. This simple model is sufficient for
  1003. a wide variety of styles, but doesn't cover some common effects. The
  1004. concept of pseudo-classes and pseudo-elements extend addressing in CSS1
  1005. to allow external information to influence the formatting process.
  1006.  
  1007.    Pseudo-classes and pseudo-elements can be used in CSS selectors, but
  1008. do not exist in the HTML source. Rather, they are "inserted" by the UA
  1009. under certain conditions to be used for addressing in style sheets.
  1010. They are referred to as "classes" and "elements" since this is a
  1011. convenient way of describing their behavior. More specifically, their
  1012. behavior is defined by a fictional tag sequence.
  1013.  
  1014.    Pseudo-elements are used to address sub-parts of elements, while
  1015. pseudo-classes allow style sheets to differentiate between different
  1016. element types.
  1017.  
  1018.    The only support pseudo-classes in Emacs/W3 are on the anchor tag
  1019. (<a>...</a>).
  1020.  
  1021.    User agents commonly display newly visited anchors differently from
  1022. older ones. In CSS1, this is handled through pseudo-classes on the 'A'
  1023. element:
  1024.  
  1025.        A:link { color: red }       /* unvisited link */
  1026.        A:visited { color: blue }   /* visited links */
  1027.        A:active { color: lime }    /* active links */
  1028.  
  1029.    All 'A' elements with an 'HREF' attribute will be put into one and
  1030. only one of these groups (i.e. target anchors are not affected). UAs may
  1031. choose to move an element from 'visited' to 'link' after a certain
  1032. time. An 'active' link is one that is currently being selected (e.g. by
  1033. a mouse button press) by the reader.
  1034.  
  1035.    The formatting of an anchor pseudo-class is as if the class had been
  1036. inserted manually. A UA is not required to reformat a currently
  1037. displayed document due to anchor pseudo-class transitions. E.g., a style
  1038. sheet can legally specify that the 'font-size' of an 'active' link
  1039. should be larger that a 'visited' link, but the UA is not required to
  1040. dynamically reformat the document when the reader selects the 'visited'
  1041. link.
  1042.  
  1043.    Pseudo-class selectors do not match normal classes, and vice versa.
  1044. The style rule in the example below will therefore not have any
  1045. influence:
  1046.  
  1047.        A:link { color: red }
  1048.      
  1049.        <A CLASS=link NAME=target5> ... </A>
  1050.  
  1051.    In CSS1, anchor pseudo-classes have no effect on elements other than
  1052. 'A'. Therefore, the element type can be omitted from the selector:
  1053.  
  1054.        A:link { color: red }
  1055.        :link { color: red }
  1056.  
  1057.    The two selectors above will select the same elements in CSS1.
  1058.  
  1059.    Pseudo-class names are case-insensitive.
  1060.  
  1061.    Pseudo-classes can be used in contextual selectors:
  1062.  
  1063.        A:link IMG { border: solid blue }
  1064.  
  1065.    Also, pseudo-classes can be combined with normal classes:
  1066.  
  1067.        A.external:visited { color: blue }
  1068.      
  1069.        <A CLASS=external HREF="http://out.side/">external link</A>
  1070.  
  1071.    If the link in the above example has been visited, it will be
  1072. rendered in blue. Note that normal class names precede pseudo-classes
  1073. in the selector.
  1074.  
  1075. 
  1076. File: w3.info,  Node: The Cascade,  Next: Properties,  Prev: Pseudo-Classes/Elements,  Up: Stylesheets
  1077.  
  1078. The Cascade
  1079. ===========
  1080.  
  1081.    In CSS, more than one style sheet can influence the presentation
  1082. simultaneously. There are two main reasons for this feature: modularity
  1083. and author/reader balance.
  1084.  
  1085. modularity
  1086.      A style sheet designer can combine several (partial) style sheets
  1087.      to reduce redundancy:
  1088.  
  1089.             @import url(http://www.style.org/pastoral);
  1090.             @import url(http://www.style.org/marine);
  1091.           
  1092.             H1 { color: red }     /* override imported sheets */
  1093.  
  1094. author/reader balance
  1095.      Both readers and authors can influence the presentation through
  1096.      style sheets. To do so, they use the same style sheet language
  1097.      thus reflecting a fundamental feature of the web: everyone can
  1098.      become a publisher. The UA is free to choose the mechanism for
  1099.      referencing personal style sheets.
  1100.  
  1101.    Sometimes conflicts will arise between the style sheets that
  1102. influence the presentation. Conflict resolution is based on each style
  1103. rule having a weight. By default, the weights of the reader's rules are
  1104. less than the weights of rules in the author's documents. I.e., if
  1105. there are conflicts between the style sheets of an incoming document
  1106. and the reader's personal sheets, the author's rules will be used. Both
  1107. reader and author rules override the UA's default values.
  1108.  
  1109.    The imported style sheets also cascade with each other, in the order
  1110. they are imported, according to the cascading rules defined below. Any
  1111. rules specified in the style sheet itself override rules in imported
  1112. style sheets. That is, imported style sheets are lower in the cascading
  1113. order than rules in the style sheet itself. Imported style sheets can
  1114. themselves import and override other style sheets, recursively.
  1115.  
  1116.    In CSS1, all '@import' statements must occur at the start of a style
  1117. sheet, before any declarations. This makes it easy to see that rules in
  1118. the style sheet itself override rules in the imported style sheets.
  1119.  
  1120.    NOTE: The use of !important in CSS stylesheets is unsupported at
  1121. this time.
  1122.  
  1123.    Conflicting rules are intrinsic to the CSS mechanism. To find the
  1124. value for an element/property combination, the following algorithm must
  1125. be followed:
  1126.  
  1127.   1. Find all declarations that apply to the element/property in
  1128.      question. Declarations apply if the selector matches the element in
  1129.      question. If no declarations apply, the inherited value is used. If
  1130.      there is no inherited value (this is the case for the 'HTML'
  1131.      element and for properties that do not inherit), the initial value
  1132.      is used.
  1133.  
  1134.   2. Sort the declarations by explicit weight: declarations marked
  1135.      '!important' carry more weight than unmarked (normal) declarations.
  1136.  
  1137.   3. Sort by origin: the author's style sheets override the reader's
  1138.      style sheet which override the UA's default values. An imported
  1139.      style sheet has the same origin as the style sheet from which it
  1140.      is imported.
  1141.  
  1142.   4. Sort by specificity of selector: more specific selectors will
  1143.      override more general ones. To find the specificity, count the
  1144.      number of ID attributes in the selector (a), the number of CLASS
  1145.      attributes in the selector (b), and the number of tag names in the
  1146.      selector (c). Concatenating the three numbers (in a number system
  1147.      with a large base) gives the specificity. Some examples:
  1148.             LI            {...}  /* a=0 b=0 c=1 -> specificity =   1 */
  1149.             UL LI         {...}  /* a=0 b=0 c=2 -> specificity =   2 */
  1150.             UL OL LI      {...}  /* a=0 b=0 c=3 -> specificity =   3 */
  1151.             LI.red        {...}  /* a=0 b=1 c=1 -> specificity =  11 */
  1152.             UL OL LI.red  {...}  /* a=0 b=1 c=3 -> specificity =  13 */
  1153.             #x34y         {...}  /* a=1 b=0 c=0 -> specificity = 100 */
  1154.      Pseudo-elements and pseudo-classes are counted as normal elements
  1155.      and classes, respectively.
  1156.  
  1157.   5. Sort by order specified: if two rules have the same weight, the
  1158.      latter specified wins. Rules in imported style sheets are
  1159.      considered to be before any rules in the style sheet itself.
  1160.  
  1161.    The search for the property value can be terminated whenever one rule
  1162. has a higher weight than the other rules that apply to the same
  1163. element/property combination.
  1164.  
  1165.    This strategy gives author's style sheets considerably higher weight
  1166. than those of the reader. It is therefore important that the reader has
  1167. the ability to turn off the influence of a certain style sheet, e.g.
  1168. through a pull-down menu.
  1169.  
  1170.    A declaration in the 'STYLE' attribute of an element has the same
  1171. weight as a declaration with an ID-based selector that is specified at
  1172. the end of the style sheet:
  1173.  
  1174.      <STYLE TYPE="text/css">
  1175.        #x97z { color: blue }
  1176.      </STYLE>
  1177.      
  1178.      <P ID=x97z STYLE="color: red">
  1179.  
  1180.    In the above example, the color of the 'P' element would be red.
  1181. Although the specificity is the same for both declarations, the
  1182. declaration in the 'STYLE' attribute will override the one in the
  1183. 'STYLE' element because of cascading rule number 5.
  1184.  
  1185.    The UA may choose to honor other stylistic HTML attributes, for
  1186. example 'ALIGN'. If so, these attributes are translated to the
  1187. corresponding CSS rules with specificity equal to 1. The rules are
  1188. assumed to be at the start of the author style sheet and may be
  1189. overridden by subsequent style sheet rules. In a transition phase, this
  1190. policy will make it easier for stylistic attributes to coexist with
  1191. style sheets.
  1192.  
  1193. 
  1194. File: w3.info,  Node: Properties,  Next: Units,  Prev: The Cascade,  Up: Stylesheets
  1195.  
  1196. Properties
  1197. ==========
  1198.  
  1199.    In the text below, the allowed values for each property are listed
  1200. with a syntax like the following:
  1201.  
  1202.            Value: N | NW | NE
  1203.            Value: [ <length> | thick | thin ]{1,4}
  1204.            Value: <uri>? <color> [ / <color> ]?
  1205.            Value: <uri> || <color>
  1206.  
  1207.    The words between < and > give a type of value. The most common types
  1208. are <length>, <percentage>, <url>, <number>and <color> these are
  1209. described in the section on [[units]]. The more specialized types (e.g.
  1210. <font-family>and <border-style>) are described under the property where
  1211. they appear.
  1212.  
  1213.    Other words are keywords that must appear literally, without quotes.
  1214. The slash (/) and the comma (,) must also appear literally.
  1215.  
  1216.    Several things juxtaposed mean that all of them must occur, in the
  1217. given order. A bar (|) separates alternatives: one of them must occur. A
  1218. double bar (A || B) means that either A or B or both must occur, in any
  1219. order. Brackets ([]) are for grouping. Juxtaposition is stronger than
  1220. the double bar, and the double bar is stronger than the bar. Thus "a b |
  1221. c || d e" is equivalent to "[ a b ] | [ c || [ d e ]]".
  1222.  
  1223.    Every type, keyword, or bracketed group may be followed by one of the
  1224. following modifiers:
  1225.  
  1226.    * An asterisk (*) indicates that the preceding type, word or group is
  1227.      repeated zero or more times.
  1228.  
  1229.    * A plus (+) indicates that the preceding type, word or group is
  1230.      repeated one or more times.
  1231.  
  1232.    * A question mark (?) indicates that the preceding type, word or
  1233.      group is optional.
  1234.  
  1235.    * A pair of numbers in curly braces ({A,B}) indicates that the
  1236.      preceding type, word or group is repeated at least A and at most B
  1237.      times.
  1238.  
  1239.    Other than the value the following information is also shown.
  1240.  
  1241. Supported      If this is present, it lists the parts of the              
  1242. Values:        specification that Emacs/W3 currently supports.            
  1243. Unsupported    If this is present, it represents the parts of the         
  1244. Values:        specifcation that Emacs/W3 does not support.               
  1245. Initial:       The default value for the property, unless explicitly set  
  1246.                in a stylesheet.                                           
  1247. Applies to:    What type of elements this property can be attached to.    
  1248. Inherited:     Yes or no                                                  
  1249. Percentage     What a percentage value applies to when given.             
  1250. values:                                                                   
  1251.  
  1252. * Menu:
  1253.  
  1254. * Font Properties::             Selecting fonts, styles, and sizes.
  1255. * Colors and Backgrounds::      Controlling colors, front and back.
  1256. * Text Properties::             Alignment, decoration, and more!
  1257. * Box Properties::              Borders, padding, and margins, oh my!
  1258. * Classification::              Changing whitespace and display policies.
  1259. * Media Selection::             Conditionalize stylesheets on media-type.
  1260. * Speech Properties::           Speech output controlled by stylesheets.
  1261.  
  1262. 
  1263. File: w3.info,  Node: Font Properties,  Next: Colors and Backgrounds,  Prev: Properties,  Up: Properties
  1264.  
  1265. Font Properties
  1266. ---------------
  1267.  
  1268.    Setting font properties will be among the most common uses of style
  1269. sheets.  Unfortunately, there exists no well-defined and universally
  1270. accepted taxonomy for classifying fonts, and terms that apply to one
  1271. font family may not be appropriate for others. E.g. 'italic' is commonly
  1272. used to label slanted text, but slanted text may also be labeled as
  1273. being Oblique, Slanted, Incline, Cursive or Kursiv. Therefore it is not
  1274. a simple problem to map typical font selection properties to a specific
  1275. font.
  1276.  
  1277.    The properties defined by CSS1 are described in the following
  1278. sections.
  1279.  
  1280. * Menu:
  1281.  
  1282. * font-family::                 Groups of fonts.
  1283. * font-style::                  Normal, italic, or oblique?
  1284. * font-variant::                Small-caps, etc.
  1285. * font-weight::                 How bold can you go?
  1286. * font-size::                   How big is yours?
  1287. * font::                        Shorthand for all of the above.
  1288.  
  1289. 
  1290. File: w3.info,  Node: font-family,  Next: font-style,  Prev: Font Properties,  Up: Font Properties
  1291.  
  1292. font-family
  1293. ...........
  1294.  
  1295. Supported      [[<family-name> | <generic-family>],]* [<family-name> |    
  1296. Values:        <generic-family>]                                          
  1297. Initial:       User specific                                              
  1298. Applies to:    all elements                                               
  1299. Inherited:     yes                                                        
  1300. Percentage     N/A                                                        
  1301. values:                                                                   
  1302.  
  1303.    The value is a prioritized list of font family names and/or generic
  1304. family names. Unlike most other CSS1 properties, values are separated
  1305. by a comma to indicate that they are alternatives:
  1306.  
  1307.        BODY { font-family: gill, helvetica, sans-serif }
  1308.  
  1309.    There are two types of list values:
  1310.  
  1311. <family-name>
  1312.      The name of a font family of choice. In the last example, "gill"
  1313.      and "helvetica" are font families.
  1314.  
  1315. <generic-family>
  1316.      In the example above, the last value is a generic family name. The
  1317.      following generic families are defined:
  1318.         * 'serif' (e.g. Times)
  1319.  
  1320.         * 'sans-serif' (e.g. Helvetica)
  1321.  
  1322.         * 'cursive' (e.g. Zapf-Chancery)
  1323.  
  1324.         * 'fantasy' (e.g. Western)
  1325.  
  1326.         * 'monospace' (e.g. Courier)
  1327.  
  1328.    Style sheet designers are encouraged to offer a generic font family
  1329. as a last alternative.
  1330.  
  1331.    Font names containing whitespace should be quoted:
  1332.  
  1333.        BODY { font-family: "new century schoolbook", serif }
  1334.      
  1335.        <BODY STYLE="font-family: 'My own font', fantasy">
  1336.  
  1337.    If quoting is omitted, any whitespace characters before and after the
  1338. font name are ignored and any sequence of whitespace characters inside
  1339. the font name is converted to a single space.
  1340.  
  1341. 
  1342. File: w3.info,  Node: font-style,  Next: font-variant,  Prev: font-family,  Up: Font Properties
  1343.  
  1344. font-style
  1345. ..........
  1346.  
  1347. Supported      normal | italic | oblique                                  
  1348. Values:                                                                   
  1349. Initial:       normal                                                     
  1350. Applies to:    all elements                                               
  1351. Inherited:     yes                                                        
  1352. Percentage     N/A                                                        
  1353. values:                                                                   
  1354.  
  1355.    The 'font-style' property selects between normal (sometimes referred
  1356. to as "roman" or "upright"), italic and oblique faces within a font
  1357. family.
  1358.  
  1359.    A value of 'normal' selects a font that is classified as 'normal' in
  1360. the UA's font database, while 'oblique' selects a font that is labeled
  1361. 'oblique'. A value of 'italic' selects a font that is labeled 'italic',
  1362. or, if that is not available, one labeled 'oblique'.
  1363.  
  1364.    The font that is labeled 'oblique' in the UA's font database may
  1365. actually have been generated by electronically slanting a normal font.
  1366.  
  1367.    Fonts with Oblique, Slanted or Incline in their names will typically
  1368. be labeled 'oblique' in the UA's font database. Fonts with Italic,
  1369. Cursive or Kursiv in their names will typically be labeled 'italic'.
  1370.  
  1371.        H1, H2, H3 { font-style: italic }
  1372.        H1 EM { font-style: normal }
  1373.  
  1374.    In the example above, emphasized text within 'H1' will appear in a
  1375. normal face.
  1376.  
  1377.